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Two Types of Docs 


e Reference 


e Tutorial 


Reference docs 
e Comprehensive 
e Focus on the product 


e Quick retrieval 


application/json 


One of 


;7 name 
required 


4 region 


size 
required 


4 image > 


required 


Multiple Droplet Request 


string 

The human-readable string you wish to use when displaying the 
Droplet name. The name, if set to a domain name managed in 
the DigitalOcean DNS management system, will configure a PTR 
record for the Droplet. The name set during creation will also 
determine the hostname for the Droplet in its internal 
configuration. 


string 

The slug identifler for the region that you wish to deploy the 
Droplet in. If the specific datacenter is not not important, a slug 
prefix (e.g. nyc ) can be used to deploy the Droplet in any of the 
that region's locations ( nyc1 , nyc2 , or nyc3 ). If the region is 
omitted from the create request completely, the Droplet may 
deploy in any region. 


string 
The slug identifler for the size that you wish to select for this 
Droplet. 


string or integer 

The image ID of a public or private image or the slug identifler for 
a public image. This image will be the base image for your 
Droplet. 


“user_data™: 


“vpc_uuid"™: @e09 dc84-11e8-98: 


Response samples 


Content type 
application/json 


Example 
Single Droplet Create Response 


Copy Expandall Collapse all 


"droplet" 
sid: 
"name": “example.cc 
"memory": 1 ; 
“vcpus™: 
"disk": 
"locked": 


Tutorial docs 


e Not comprehensive 
e Focus on the user 


e Read beginning to end 


Once you're done setting this up, log in as your non-root user and proceed 
CONTENTS to the first step. 


Step 1 - Installing Apache 


Step 1 — Installing 
Apache : ‘ rr a —_ 
Apache is available within Ubuntu’s default software repositories, making it 
Step 2 — Adjusting possible to install it using conventional package management tools. 
the Firewall 
Begin by updating the local package index to reflect the latest upstream 
Step 3 Checking changes: 
your Web Serve 
Step 4 $ update 


the Apache Process 


; Then, install the apache2 package: 
Step 5 — Setting Up P P g 


Virtual Hosts 


(Recommended) $ Beeches 


Step 6 - Getting 


After confirming the installation, apt will install Apache and all required 


Familiar with : 
dependencies. 


t 
Important Apache 


Files and Directories 


Step 2 — Adjusting the Firewall 


Conclicinn 


File menu 


| File Edit View Insert 

iD New...  Ctrl+N 

‘@ Open... Ctri+0 
Close 


: i Save = Ctrl+S 
; Save As... 
Save as HTML... 
¥ersions... 


Page Setup... 
[& Print Preview 
& Print... Ctrl+P 


Send To > 
Properties 


Exit 


New - Opens a new document. If you use the keyboard combination indicated on the right a blank 
document opens immediately. Selecting the New menu item with your cursor gives the opportunity to 
open a large number of types of documents. 


Open - Opens a previously saved document. 
Close - Closes the active document but does not quit the application. 
Save - Saves the active document with its current file name, location and format. 


Save As - Saves by opening a window which gives the opportunity to change the file name, location or 
format. 


Page Setup - Sets margins, paper size, orientation and other layout options. 
Print Preview - Shows how the file will look when you print it. 
Print - Prints the active file, also gives the opportunity to change print options 


Exit - Closes Microsoft Word. 


When You Organize by Noun 


Document Store 
(Azure Files) 


Git Source Control 


Azure 
Container 
Registry 


Secrets Mgmt 


Logging, Telemetry 


Azure KeyVault Azure Monitor 


@ 
r J} ) : ? y 
4 : =~ 7 
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WLLL 


CONTENTS 
Prerequisites 


Step 1 — Installing 
Apache 
Step 2 — Adjusting 


the Firewall 


Step 3 — Checking 


your Web Server 
Step 4 — Managing 


the Apache Process 


Step 5 — Setting Up 
Virtual Hosts 
(Recommended) 
Step 6 - Getting 
Familiar with 
Important Apache 


Files and Directories 


Conclicinn 


Once you're done setting this up, log in as your non-root user and proceed 
to the first step. 


Step 1 - Installing Apache 


Apache is available within Ubuntu’s default software repositories, making it 
possible to install it using conventional package management tools. 


Begin by updating the local package index to reflect the latest upstream 
changes: 


$ update 


Then, install the apache2 package: 


$ 3 1 apache2 


After confirming the installation, apt will install Apache and all required 
dependencies. 


Step 2 - Adjusting the Firewall 


a Server | ro youll ll - 


Writing at the step level 


e Look for the verb 


1. Enter the URL 
2. Press Enter 


Writing at the step level 


e Look for the verb 


e Steps should be complete, and in order 


How To View a Web Page 


1. Start the browser 
2. Click in the address bar 
3. Type inthe URL 

4. Press Enter 


Writing at the step level 


e Look for the verb 
e Steps should be in order 
e Practice “just in time” learning 


How To View a Web Page 


1. Start the browser 
2. Click in the address bar 
3. Type inthe web address 
a. A web address is also called a URL. It represents a location 
on the web to navigate to. 
4. Press Enter 


Step 1 - Installing Apache 


Apache is available within Ubuntu’s default software repositories, making it 
possible to install it using conventional package management tools. 


Begin by updating the local package index to reflect the latest upstream 
changes: 


$ sudo apt update 


Then, install the apache2 package: 


$ sudo apt install apache2 


After confirming the installation, apt will install Apache and all required 
dependencies. 


Step 2 -— Adjusting the Firewall 


Writing at the step level 


Look for the verb 

Steps should be in order 
Practice “just in time” learning 
Keep them short 

Use signposts 


Writing at the step level 


Look for the verb 
Steps should be in order 
Practice “just in time” learning 
Keep them short 
Use signposts 

o Introduction 

o Transitions 

o Conclusion 


The installation process will ask you about importing a GPG key. Confirm it so the installation can 
complete. 


Now that you have Certbot installed, let’s run it to get a certificate. 
Step 2 —- Confirming Nginx’s Configuration 
Certbot needs to be able to find the correct server block in your Nginx configuration for it to be 


able to automatically configure SSL. Specifically, it does this by looking for a server_name directive 
that matches the domain you request a certificate for. 


Writing at the paragraph level 


Writing at the paragraph level 


e Keep it concise 


To add the Rocky Linux 9 EPEL repository, run the following command: 


all epel-release 


When asked to confirm the installation, type and enter y. 


Now that you have access to the extra repository, install all of the required packages: 


1 certbot python3-certbot-nginx 


This will install Certbot itself and the Nginx plugin for Certbot, which is needed to run the program. 


The installation process will ask you about importing a GPG key. Confirm it so the installation can 
complete. 


Now that you have Certbot installed, let’s run it to get a certificate. 


Writing at the paragraph level 


e Keep it concise 
e Make it relevant 


Step 1. Installing Apache 
sudo apt install apache2 

Step 2. Configuring Apache 

a. Adjusting the Firewall 

b. Checking the Server 

c. Managing the Processes 

d. Setting Up Virtual Hosts 

e. Configuring Log Files 
Conclusion] 


Step 1. Installing Apache 
sudo apt install apache2 
Step 2. Configuring Apache 
Step 3. Adjusting the Firewall 
Step 4. Checking the Server 
Step 5. Managing the Processes 
Step 6. Setting Up Virtual Hosts 
Step 7. Configuring Log Files 
Conclusion 


Writing at the sentence level 


Writing at the sentence level 


e Look for the verb 


The firewall settings are the next thing you need to 
change, so open the config file to do that. 


Writing at the sentence level 


e Look for the verb 


The firewall settings are the next thing you need to 
change, so open the config file to do that. 


Open the config file to change the firewall settings. 


Writing at the sentence level 


e Look for the verb 
e Use active voice 


The newuser command ts used to create a new user. 


Writing at the sentence level 


e Look for the verb 
e Use active voice 


The newuser command is used to create a new user. 


Create a new user with the newuser command. 


Writing at the sentence level 


e Look for the verb 
e Use active voice 
e Keep it short 


Configure the firewall by opening the config file for 
editing, navigating to the allowed ports section, adding 
the ports that you want to open, and saving the file. 


Writing at the sentence level 


e Look for the verb 
e Use active voice 
e Keep it short 


Configure the firewall by opening the config file for 
editing, navigating to the allowed ports section, adding 
the ports that you want to open, and saving the file. 


Configure the firewall by opening the config file for 
editing. Navigate to the allowed ports section. Add the 
ports that you want to open. Then save the file. 


ice in a well-maintair 
firewall contiguratio 


Writing tone 


e Beconfident casual 


His+mpertantHe-+remenmberthat security ist primary 
importance in a well-maintained system. Therefore, 
plan your firewall configuration to allow access only on 
those@orts essenttatte businessreeds. 


Configure your firewall to open only the ports you 
need to. 


sual 


‘reader in sec 


r for tt 


Writing tone 


e Beconfident casual 
e Address the reader in second-person: “you” 


Next, we'll! create a dedicated user for the database 
instance. 


Next,  —_~ create a dedicated user for the database 
instance. 


rch un | 


Writing tone 


Be confident casual 

Address the reader in second-person: “you” 
Use your audience's vocabulary 

Avoid “easy” and “simple” 


Configuring a new container in Kubernetes isnt as 
hard as it sounds. You simply.add the proper YAML to 
the kubecti file. 


To configure a new container in Kubernetes, you add 
the proper YAML to the kubecti file. 


Writing tone 


Be confident casual 

Address the reader in second-person: “you” 
Use your audience's vocabulary 

Avoid “easy” and “simple” 

No marketing copy 


FooBar.is a powerful new JavaScript framework that 
allows you to load complex Uls at !ightning speed. 


Foobar is a JavaScript framework that allows you to 
load complex Uls more quickly. 


Thank You 


Brian MacDonald bmacdonald@digitalocean.com 
All Things Open 2022 @bmac_editor 


Write for DOnations: www.do.co/w4do 


